Docs: runnable model tasks and verified book links - #53

Outcome

A reader can run a bounded PCA forecast from the README or Quickstart with the base wheel, verify (2, 6) finite output, and follow task guides to exact generated API signatures and pinned public teaching files. The mobile documentation menu is visible at widths where Material hides tabs.

Closes #52.

Capability inventory

The public 0.1 API has no designated experimental model family. _internal is unstable. The package does not fetch data, compute diagnostics, or simulate trades. Neural examples require deep; Parquet and Specs adapters require integration. Two-to-four-step neural smoke runs verify contracts only. Full book training and case-study registry runs need book data and longer compute.

Verification

• Built ml4t_models-0.1.4-py3-none-any.whl. Installed it into clean Python 3.12 environments under /tmp, one base and one with deep, and ran the README block, Quickstart block, and all seven repository examples from outside the source tree. All assertions passed. portfolio_learning.py also passed in the base-only environment.
• Public companion revision: d2edec54b1c7a6a9d7a97d8129eb05db4491e1eb of stefan-jansen/machine-learning-for-trading. Checked 10 distinct linked files against its Git tree and inspected notebook code for ml4t.models use. Chapter 14 teaching notebooks 04-09 and Chapter 17 notebooks 11-13 do not call the library; the case-study library_bridge.py does.
• Strict MkDocs build passed. Rendered link check resolved 4,482 local links and anchors. Reviewed home at 1440px and 390px; fixed the missing narrow-width menu.
• Ruff check and format, ty check, 423 tests, coverage gate (95.49% lines, 85.29% branches), uv build, and pre-commit run --all-files passed. Commit hook passed the same configured checks.

Review limits and follow-up

• Book notebooks and full research training were not rerun. Their data, package, and training requirements are described in the Book Guide; the small wheel examples are the executable API checks here.
• No documentation deployment or release was performed by this PR. The deployed route should be checked after merge and the next documentation publication.
• The book repository has no reciprocal link to this library's task guides. Its owner can add those links on the next book update; this PR makes the library documentation useful without them.

CI result

At public commit 39926d7703dba87204c01094102343edddcc057a, all 33 completed PR checks passed, including the cross-platform Python matrix and MPS neural qualification. Two workflow jobs were skipped by their configured conditions, including the RTX 3090 CUDA and performance job. GitHub reports the PR mergeable with a clean merge state.